健康锻炼数据（HealthWorkout） PRO#

HealthWorkout 类提供了访问和分析 Apple 健康应用中锻炼数据的接口。每个锻炼实例代表一次完整的锻炼会话，包括活动类型、开始与结束时间、持续时长，以及相关的事件与统计数据。

使用场景#

• 获取用户的锻炼历史记录
• 分析锻炼类型与锻炼时间
• 结合锻炼期间采集的健康数据（如心率、卡路里、距离等）进行评估
• 可视化锻炼过程中的事件（如暂停、恢复、圈数、分段）
• 获取锻炼期间的统计指标，如平均心率或总能量消耗

属性说明#

相关类型说明#

HealthWorkoutActivityType#

表示此次锻炼的具体类型，例如：

• running（跑步）
• walking（步行）
• cycling（骑行）
• swimming（游泳）
• yoga（瑜伽）
• 等其他 Apple Health 支持的活动类型（参考 HealthWorkoutActivityType 文档）

HealthWorkoutEvent#

锻炼过程中记录的事件类型，例如：

• 暂停 (pause)
• 恢复 (resume)
• 运动暂停/恢复 (motionPaused / motionResumed)
• 圈数标记 (lap)
• 分段标记 (segment)

HealthStatistics#

统计锻炼期间采集到的健康数据，可用的方法包括：

• averageQuantity()：平均值
• sumQuantity()：总和
• maximumQuantity()：最大值
• minimumQuantity()：最小值
• mostRecentQuantity()：最近一次的值

示例代码#

1function showWorkout(workout: HealthWorkout) {
2  console.log(`锻炼 ID: ${workout.uuid}`)
3  console.log(`活动类型: ${workout.workoutActivityType}`)
4  console.log(`开始时间: ${workout.startDate.toISOString()}`)
5  console.log(`结束时间: ${workout.endDate.toISOString()}`)
6  console.log(`持续时长: ${(workout.duration / 60).toFixed(1)} 分钟`)
7
8  if (workout.metadata) {
9    console.log(`元数据: ${JSON.stringify(workout.metadata)}`)
10  }
11
12  if (workout.workoutEvents) {
13    for (const event of workout.workoutEvents) {
14      console.log(`事件: ${HealthWorkoutEventType[event.type]} 时间: ${event.dateInterval.start.toISOString()}`)
15    }
16  }
17
18  const stats = workout.allStatistics["heartRate"]
19  if (stats) {
20    console.log(`平均心率: ${stats.averageQuantity("count/min")} bpm`)
21  }
22}

补充说明#

• HealthWorkout 实例通常由类似 Health.queryWorkouts() 的方法获取（取决于框架支持的 API）。
• allStatistics 属性可快速访问锻炼期间的聚合数据，避免手动查询每个样本。
• workoutEvents 可用于还原锻炼过程中的行为轨迹，例如暂停与恢复的时间点。